home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / emulation / c64 / over5 / doc / over5.doc < prev    next >
Text File  |  1996-09-07  |  9KB  |  355 lines
  1. Documentation for Over5 0.587 by Daniel Kahlin <tlr@stacken.kth.se>
  2. -----------------------------------------------------------------------------
  3. Copyright (c) 1995,1996 Daniel Kahlin <tlr@stacken.kth.se>
  4.  
  5. Distribution:
  6.  
  7.   Over5 is FREEWARE (Freely-Distributable), but copyrighted by me. (NOT PD!) 
  8. None of the included files may be modified and/or removed.  Permission is
  9. given to freely distribute this program provided you include all files from
  10. the original archive, and no fee is charged in excess of reasonable media
  11. and mailing costs.  The program may not be used for commercial purposes
  12. without written permission from the author.
  13.  
  14.  
  15. Disclaimer:
  16.  
  17.   I cannot in any way be held responsible for anything this program does.
  18. You are using it entirely at your own risk.  Every effort has been made to
  19. keep this program bug free.  But, IF for example a bug exists that blows up
  20. your entire computer, don't blame me.
  21.  
  22. -----------------------------------------------------------------------------
  23.  
  24. Over5 on the WWW: (contains the latest release)
  25.   http://www.stacken.kth.se/~tlr/computing/over5.html
  26.  
  27. GENERAL:
  28.  
  29.   Over5 (the successor to OverFour) is an AMIGA to/from C64 transfer program
  30. package.  It was made because of too many burnt 6526's and 8520's.  To overcome
  31. that problem I chose to use a standard RS-232 interface.
  32.  
  33. Over5 contains several commands: COPY, WRITEFILE, READFILE, WRITEMEM, READMEM,
  34. SYS, RUN, RESET, SIMPLEWRITE, SIMPLEREAD, BOOT, DIR, STATUS, COMMAND,
  35. WRITEDISK, READDISK, WRITEZIP, READZIP, TEST, SERVER, HELP.
  36.  
  37.  
  38.  
  39. Documentation:
  40.  
  41.  
  42. command COPY:
  43. -------------
  44.  
  45. TEMPLATE: Over5 COPY FROM/M,TO/A,DEBUG/S
  46.  
  47.   FROM/M    source file/files 
  48.   TO/A      destination file/path
  49.   DEBUG/S   sets debug mode (shows all packets).
  50.  
  51. copies source to destination (like AmigaDOS copy) but '8:' is the 1541.
  52. The wildcard '*' can be used. (no wildcards on amigafiles, SORRY!)
  53.  
  54. example: copy 8:disksl* ram:
  55.  
  56.  
  57. command WRITEFILE:
  58. ------------------
  59. (this is a low level command, generally you should use 'COPY' instead)
  60.  
  61. TEMPLATE: Over5 WRITEFILE FROM/A,TO/A,DEVICE/N,DEBUG/S
  62.  
  63.   FROM/A    source file 
  64.   TO/A      destination file
  65.   DEVICE/N  1541 device number
  66.   DEBUG/S   sets debug mode (shows all packets).
  67.  
  68. copies source file from the amiga to the destination file on the 1541.
  69.  
  70.  
  71. command READFILE:
  72. -----------------
  73. (this is a low level command, generally you should use 'COPY' instead)
  74.  
  75. TEMPLATE: Over5 READFILE FROM/A,TO/A,DEVICE/N,DEBUG/S
  76.  
  77.   FROM/A    source file 
  78.   TO/A      destination file
  79.   DEVICE/N  1541 device number
  80.   DEBUG/S   sets debug mode (shows all packets).
  81.  
  82. copies source file from the 1541 to the destination file on the amiga.
  83.  
  84.  
  85. command WRITEMEM:
  86. ------------------
  87.  
  88. TEMPLATE: Over5 WRITEMEM FROM/A,NEWADDR,RUN/S,RESET/S,DEBUG/S
  89.  
  90.   FROM/A    source file 
  91.   NEWADDR   optional load address
  92.   RUN/S     execute file with 'RUN' after transfer.
  93.   RESET/S   do reset on the c64 before transfer (with special hardware)
  94.   DEBUG/S   sets debug mode (shows all packets).
  95.  
  96. Writes source file into the c64 memory.
  97.  
  98.  
  99. command READMEM:
  100. ----------------
  101.  
  102. TEMPLATE: Over5 READMEM START/A,END/A,TO/A,RESET/S,DEBUG/S
  103.  
  104.   START/A   start address
  105.   END/A     end address
  106.   TO/A      destination file 
  107.   RESET/S   do reset on the c64 before transfer (with special hardware)
  108.   DEBUG/S   sets debug mode (shows all packets).
  109.  
  110. Reads c64 memory between START and END to the destination file.
  111.  
  112.  
  113. command SYS:
  114. ------------
  115.  
  116. TEMPLATE: Over5 SYS PC/A,MEMORY,SR,AC,XR,YR,SP,RESET/S,DEBUG/S
  117.  
  118.   PC/A      programcounter
  119.   MEMORY    contents of $01  (default 0x37)
  120.   SR        status register  (default 0x00)
  121.   AC        Accumulator      (default 0x00)
  122.   XR        X index register (default 0x00)
  123.   YR        Y index register (default 0x00)
  124.   SP        Stack pointer    (default 0xff)
  125.   RESET/S   do reset on the c64 before sys (with special hardware)
  126.   DEBUG/S   sets debug mode (shows all packets).
  127.  
  128. Starts code beginning at pc.
  129.  
  130.  
  131. command RUN:
  132. ------------
  133.  
  134. TEMPLATE: Over5 RUN DEBUG/S
  135.  
  136.   DEBUG/S   sets debug mode (shows all packets).
  137.  
  138. Not yet implemented!
  139.  
  140.  
  141. command RESET:
  142. --------------
  143.  
  144. TEMPLATE: Over5 RESET DEBUG/S
  145.  
  146.   DEBUG/S   sets debug mode (shows all packets).
  147.  
  148. does reset on the c64 (with special hardware)
  149.  
  150.  
  151.  
  152. command SIMPLEWRITE:
  153. --------------------
  154.  
  155. TEMPLATE: Over5 SIMPLEWRITE FROM/A,OLD/S
  156.  
  157.   FROM/A    source file 
  158.   OLD/S     obsolete protocol. use for FastRS 1.1 or earlier
  159.  
  160. Writes source file into the c64 memory using the simpleprotocol.
  161. (no handshaking)
  162.  
  163.  
  164. command SIMPLEREAD:
  165. -------------------
  166.  
  167. TEMPLATE: Over5 SIMPLEREAD TO/A,OLD/S
  168.  
  169.   TO/A      destination file 
  170.   OLD/S     obsolete protocol. Use this for FastRS 1.1 or earlier.
  171.  
  172. Reads source file from the c64 memory using the simpleprotocol.
  173. (no handshaking)
  174.  
  175.  
  176. command BOOT:
  177. -------------
  178. (this is only used to transfer 'DiskSlave' or similar for the first time)
  179.  
  180. TEMPLATE: Over5 BOOT FROM/A,SAFEADDR,NEW/S
  181.  
  182.   FROM/A    source file 
  183.   SAFEADDR  optional safeaddr for use with VIC-20 (default $c000)
  184.   NEW/S     use new protocol (only at test stage)
  185.  
  186. First it relocates the source file to $c000-len and appends 'copytail',
  187. then it sends the file at 150 baud to the c64. (no handshaking)
  188. Works together with the basic program 'boot.asc'.
  189. When transferred, just type 'SYS 49152<CR>' and save to DISK or TAPE.
  190.  
  191.  
  192. command DIR:
  193. ------------
  194.  
  195. TEMPLATE: Over5 DIR DEVICE/N,DEBUG/S
  196.  
  197.   DEVICE/N  1541 device number
  198.   DEBUG/S   sets debug mode (shows all packets).
  199.  
  200. Reads directory from the 1541 and shows it.
  201.  
  202.  
  203. command STATUS:
  204. ---------------
  205.  
  206. TEMPLATE: Over5 STATUS DEVICE/N,DEBUG/S
  207.  
  208.   DEVICE/N  1541 device number
  209.   DEBUG/S   sets debug mode (shows all packets).
  210.  
  211. Gets diskstatus from 1541 and shows it.
  212.  
  213.  
  214. command COMMAND:
  215. ----------------
  216.  
  217. TEMPLATE: Over5 COMMAND COMMAND/A,DEVICE/N,DEBUG/S
  218.  
  219.   COMMAND/A diskcommand
  220.   DEVICE/N  1541 device number
  221.   DEBUG/S   sets debug mode (shows all packets).
  222.  
  223. Sends a diskcommand to the 1541.
  224.  
  225.  
  226. command TEST:
  227. -------------
  228. (this command is not necessary for the ordinary user)
  229.  
  230. TEMPLATE: Over5 TEST BLOCK/S,FILE/S,DEBUG/S
  231.  
  232.   BLOCK/S   test block transfer
  233.   FILE/S    test file transfer
  234.   DEBUG/S   sets debug mode (shows all packets).
  235.  
  236. Tests block transfer and/or file transfer.
  237.  
  238.  
  239.  
  240.  
  241. command WRITEDISK:
  242. ------------------
  243.  
  244. TEMPLATE: Over5 WRITEDISK FROM/A,DEVICE/N,DEBUG/S
  245.  
  246.   FROM/A    source diskimage
  247.   DEVICE/N  1541 device number
  248.   DEBUG/S   sets debug mode (shows all packets).
  249.  
  250. Writes the source diskimage to the 1541.  Diskimages are usually
  251. named '.dsk' or '.d64' and should be 174848 bytes in size.
  252.  
  253.  
  254. command WRITEZIP:
  255. -----------------
  256.  
  257. TEMPLATE: Over5 WRITEZIP FROM/A,DEVICE/N,DEBUG/S
  258.  
  259.   FROM/A    zipcode basename (1!<basename>, 2!<basename>, etc...)
  260.   DEVICE/N  1541 device number
  261.   DEBUG/S   sets debug mode (shows all packets).
  262.  
  263. Decodes the zipcode archive and writes the diskimage to the 1541.
  264.  
  265.  
  266.  
  267. command READDISK:
  268. -----------------
  269.  
  270. TEMPLATE: Over5 READDISK TO/A,DEVICE/N,DEBUG/S
  271.  
  272.   TO/A      destination diskimage 
  273.   DEVICE/N  1541 device number
  274.   DEBUG/S   sets debug mode (shows all packets).
  275.  
  276. Reads an entire disk from the 1541.
  277.  
  278.  
  279.  
  280. command READZIP:
  281. ----------------
  282.  
  283. TEMPLATE: Over5 READZIP TO/A,DEVICE/N,DEBUG/S
  284.  
  285.   TO/A      zipcode basename (1!<basename>, 2!<basename>, etc...)
  286.   DEVICE/N  1541 device number
  287.   DEBUG/S   sets debug mode (shows all packets).
  288.  
  289. Reads an entire disk from the 1541 and encodes it into a standard
  290. zipcode archive.
  291. This may sometimes produce shorter archives than zipcode, but the
  292. archive will unpack fine on the c64.
  293.  
  294.  
  295.  
  296. command SERVER:
  297. ---------------
  298.  
  299. TEMPLATE: Over5 SERVER DEBUG/S
  300.  
  301.   DEBUG/S   sets debug mode (shows all packets).
  302.  
  303. Sets the amiga in SERVER MODE.  Run 'SerFile' on the c64 to use it.
  304.  
  305. commands (#C"<COMMAND>" or .<COMMAND> in 'SerFile')
  306.  
  307. .DIR or .$ or $
  308.   Displays the files in the current directory.
  309.  
  310. .CD
  311.   Displays the name of the current directory.
  312.  
  313. .CD <dir>
  314.   Set the current directory to <dir>.
  315.  
  316.  
  317.  
  318.  
  319.  
  320. command HELP:
  321. -------------
  322.  
  323. TEMPLATE: Over5 HELP or Over5 ?
  324.  
  325. Shows small help text.
  326.  
  327.  
  328.  
  329. System requirements:
  330.  
  331.   Over5 should run on any system setup running OS2.04 or higher, although it
  332. has only been tested on an A3000/25 running OS3.1.  If you find bugs or have
  333. suggestions about how to make the program better please send a bugreport or
  334. a list of suggestions to the address at the end of this text.
  335.  
  336. -----------------------------------------------------------------------------
  337.  
  338. Author:
  339.  
  340.   Daniel Kahlin is a student at the Royal Institute of Technology (Stockholm)
  341. Former c64 demo programmer (1986-1988).  He is deeply involved with computers
  342. and electronics.
  343.  
  344.    InterNet:  <tlr@stacken.kth.se>
  345.  
  346.   SnailMail:  Daniel Kahlin
  347.               Vanadisvägen 6, 2tr
  348.               s-113 46 Stockholm
  349.               Sweden
  350.  
  351.       Phone:  08-34 84 73 (+468348473)
  352.  
  353. -----------------------------------------------------------------------------
  354.  
  355.